*/
/**
- * SECTION:gtkgridlayout
- * @Short_description: Layout manager for grid-like widgets
- * @Title: GtkGridLayout
- * @See_also: #GtkBoxLayout
+ * GtkGridLayout:
*
- * GtkGridLayout is a layout manager which arranges child widgets in
- * rows and columns, with arbitrary positions and horizontal/vertical
- * spans.
+ * `GtkGridLayout` is a layout manager which arranges child widgets in
+ * rows and columns.
*
* Children have an "attach point" defined by the horizontal and vertical
* index of the cell they occupy; children can span multiple rows or columns.
* The layout properties for setting the attach points and spans are set
- * using the #GtkGridLayoutChild associated to each child widget.
+ * using the [class@Gtk.GridLayoutChild] associated to each child widget.
*
- * The behaviour of GtkGrid when several children occupy the same grid cell
- * is undefined.
+ * The behaviour of `GtkGridLayout` when several children occupy the same
+ * grid cell is undefined.
*
- * GtkGridLayout can be used like a #GtkBoxLayout if all children are attached
- * to the same row or column; however, if you only ever need a single row or
- * column, you should consider using #GtkBoxLayout.
+ * `GtkGridLayout` can be used like a `GtkBoxLayout` if all children are
+ * attached to the same row or column; however, if you only ever need a
+ * single row or column, you should consider using `GtkBoxLayout`.
*/
+/**
+ * GtkGridLayoutChild:
+ *
+ * `GtkLayoutChild` subclass for children in a `GtkGridLayout`.
+ */
#include "config.h"
#include "gtkgridlayout.h"
gobject_class->get_property = gtk_grid_layout_child_get_property;
/**
- * GtkGridLayoutChild:column:
+ * GtkGridLayoutChild:column: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_column org.gtk.Property.set=gtk_grid_layout_child_set_column)
*
* The column to place the child in.
*/
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayoutChild:row:
+ * GtkGridLayoutChild:row: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_row org.gtk.Property.set=gtk_grid_layout_child_set_row)
*
* The row to place the child in.
*/
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayoutChild:column-span:
+ * GtkGridLayoutChild:column-span: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_column_span org.gtk.Property.set=gtk_grid_layout_child_set_column_span)
*
* The number of columns the child spans to.
*/
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayoutChild:row-span:
+ * GtkGridLayoutChild:row-span: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_row_span org.gtk.Property.set=gtk_grid_layout_child_set_row_span)
*
* The number of rows the child spans to.
*/
}
/**
- * gtk_grid_layout_child_set_row:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_set_row: (attributes org.gtk.Method.set_property=row)
+ * @child: a `GtkGridLayoutChild`
* @row: the row for @child
*
* Sets the row to place @child in.
}
/**
- * gtk_grid_layout_child_get_row:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_get_row: (attributes org.gtk.Method.get_property=row)
+ * @child: a `GtkGridLayoutChild`
*
* Retrieves the row number to which @child attaches its top side.
*
}
/**
- * gtk_grid_layout_child_set_column:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_set_column: (attributes org.gtk.Method.set_property=column)
+ * @child: a `GtkGridLayoutChild`
* @column: the attach point for @child
*
* Sets the column number to attach the left side of @child.
}
/**
- * gtk_grid_layout_child_get_column:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_get_column: (attributes org.gtk.Method.get_property=column)
+ * @child: a `GtkGridLayoutChild`
*
* Retrieves the column number to which @child attaches its left side.
*
}
/**
- * gtk_grid_layout_child_set_column_span:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_set_column_span: (attributes org.gtk.Method.set_property=column-span)
+ * @child: a `GtkGridLayoutChild`
* @span: the span of @child
*
* Sets the number of columns @child spans to.
}
/**
- * gtk_grid_layout_child_get_column_span:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_get_column_span: (attributes org.gtk.Method.get_property=column-span)
+ * @child: a `GtkGridLayoutChild`
*
* Retrieves the number of columns that @child spans to.
*
}
/**
- * gtk_grid_layout_child_set_row_span:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_set_row_span: (attributes org.gtk.Method.set_property=row-span)
+ * @child: a `GtkGridLayoutChild`
* @span: the span of @child
*
* Sets the number of rows @child spans to.
}
/**
- * gtk_grid_layout_child_get_row_span:
- * @child: a #GtkGridLayoutChild
+ * gtk_grid_layout_child_get_row_span: (attributes org.gtk.Method.get_property=row-span)
+ * @child: a `GtkGridLayoutChild`
*
* Retrieves the number of rows that @child spans to.
*
gobject_class->finalize = gtk_grid_layout_finalize;
/**
- * GtkGridLayout:row-spacing:
+ * GtkGridLayout:row-spacing: (attributes org.gtk.Property.get=gtk_grid_layout_get_row_spacing org.gtk.Property.set=gtk_grid_layout_set_row_spacing)
*
* The amount of space between to consecutive rows.
*/
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayout:column-spacing:
+ * GtkGridLayout:column-spacing: (attributes org.gtk.Property.get=gtk_grid_layout_get_column_spacing org.gtk.Property.set=gtk_grid_layout_set_column_spacing)
*
* The amount of space between to consecutive columns.
*/
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayout:row-homogeneous:
+ * GtkGridLayout:row-homogeneous: (attributes org.gtk.Property.get=gtk_grid_layout_get_row_homogeneous org.gtk.Property.set=gtk_grid_layout_set_row_homogeneous)
*
* Whether all the rows in the grid have the same height.
*/
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayout:column-homogeneous:
+ * GtkGridLayout:column-homogeneous: (attributes org.gtk.Property.get=gtk_grid_layout_get_column_homogeneous org.gtk.Property.set=gtk_grid_layout_set_column_homogeneous)
*
* Whether all the columns in the grid have the same width.
*/
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
- * GtkGridLayout:baseline-row:
+ * GtkGridLayout:baseline-row: (attributes org.gtk.Property.get=gtk_grid_layout_get_baseline_row org.gtk.Property.set=gtk_grid_layout_set_baseline_row)
*
* The row to align to the baseline, when #GtkWidget:valign is set
* to %GTK_ALIGN_BASELINE.
/**
* gtk_grid_layout_new:
*
- * Creates a new #GtkGridLayout.
+ * Creates a new `GtkGridLayout`.
*
- * Returns: the newly created #GtkGridLayout
+ * Returns: the newly created `GtkGridLayout`
*/
GtkLayoutManager *
gtk_grid_layout_new (void)
}
/**
- * gtk_grid_layout_set_row_homogeneous:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_set_row_homogeneous: (attributes org.gtk.Method.set_property=row-homogeneous)
+ * @grid: a `GtkGridLayout`
* @homogeneous: %TRUE to make rows homogeneous
*
* Sets whether all rows of @grid should have the same height.
}
/**
- * gtk_grid_layout_get_row_homogeneous:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_get_row_homogeneous: (attributes org.gtk.Method.get_property=row-homogeneous)
+ * @grid: a `GtkGridLayout`
*
* Checks whether all rows of @grid should have the same height.
*
}
/**
- * gtk_grid_layout_set_row_spacing:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_set_row_spacing: (attributes org.gtk.Method.set_property=row-spacing)
+ * @grid: a `GtkGridLayout`
* @spacing: the amount of space between rows, in pixels
*
* Sets the amount of space to insert between consecutive rows.
}
/**
- * gtk_grid_layout_get_row_spacing:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_get_row_spacing: (attributes org.gtk.Method.get_property=row-spacing)
+ * @grid: a `GtkGridLayout`
*
* Retrieves the spacing set with gtk_grid_layout_set_row_spacing().
*
}
/**
- * gtk_grid_layout_set_column_homogeneous:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_set_column_homogeneous: (attributes org.gtk.Method.set_property=column-homogeneous)
+ * @grid: a `GtkGridLayout`
* @homogeneous: %TRUE to make columns homogeneous
*
* Sets whether all columns of @grid should have the same width.
}
/**
- * gtk_grid_layout_get_column_homogeneous:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_get_column_homogeneous: (attributes org.gtk.Method.get_property=column-homogeneous)
+ * @grid: a `GtkGridLayout`
*
* Checks whether all columns of @grid should have the same width.
*
}
/**
- * gtk_grid_layout_set_column_spacing:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_set_column_spacing: (attributes org.gtk.Method.set_property=column-spacing)
+ * @grid: a `GtkGridLayout`
* @spacing: the amount of space between columns, in pixels
*
* Sets the amount of space to insert between consecutive columns.
}
/**
- * gtk_grid_layout_get_column_spacing:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_get_column_spacing: (attributes org.gtk.Method.get_property=column-spacing)
+ * @grid: a `GtkGridLayout`
*
* Retrieves the spacing set with gtk_grid_layout_set_column_spacing().
*
/**
* gtk_grid_layout_set_row_baseline_position:
- * @grid: a #GtkGridLayout
+ * @grid: a `GtkGridLayout`
* @row: a row index
- * @pos: a #GtkBaselinePosition
+ * @pos: a `GtkBaselinePosition`
*
* Sets how the baseline should be positioned on @row of the
* grid, in case that row is assigned more space than is requested.
/**
* gtk_grid_layout_get_row_baseline_position:
- * @grid: a #GtkGridLayout
+ * @grid: a `GtkGridLayout`
* @row: a row index
*
- * Returns the baseline position of @row as set by
- * gtk_grid_layout_set_row_baseline_position(), or the default value
- * of %GTK_BASELINE_POSITION_CENTER.
+ * Returns the baseline position of @row.
+ *
+ * If no value has been set with
+ * [method@Gtk.GridLayout.set_row_baseline_position],
+ * the default value of %GTK_BASELINE_POSITION_CENTER
+ * is returned.
*
* Returns: the baseline position of @row
*/
}
/**
- * gtk_grid_layout_set_baseline_row:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_set_baseline_row: (attributes org.gtk.Method.set_property=baseline-row)
+ * @grid: a `GtkGridLayout`
* @row: the row index
*
* Sets which row defines the global baseline for the entire grid.
}
/**
- * gtk_grid_layout_get_baseline_row:
- * @grid: a #GtkGridLayout
+ * gtk_grid_layout_get_baseline_row: (attributes org.gtk.Method.get_property=baseline-row)
+ * @grid: a `GtkGridLayout`
*
* Retrieves the row set with gtk_grid_layout_set_baseline_row().
*